home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d6
/
kgraf.arc
/
KGTUTOR.KG
< prev
next >
Wrap
Text File
|
1989-04-01
|
11KB
|
277 lines
@DISPLAY BORDER
KWIKGRAF TUTORIAL
-----------------
(C)Copyright Alan C. Elliott, 1989
CONTENTS: 1. KWIKGRAF COMMANDS
2. RUNNING KWIKGRAF FROM DOS
3. RUNNING KWIKGRAF FROM dBASE III
4. USING A KWIKGRAF COMMAND FILE
- From DOS
- From the KWIKGRAF menu
5. USING KWIKGRAF FROM THE MENU
The Shareware concept is "try it before you buy it". If you use this
program, please become a registered user by sending in the order blank that
you will find in the documentation. By registering, you will receive the
latest version of KWIKGRAF, a printed and bound manual, and you will be
placed on the KWIK-BITS newsletter mailing list. Register today!
@END
@DISPLAY BORDER
The KWIKGRAF command line specifics what database to use, which graph to
draw, which variable in the database to use, a title, and other information
specific to the graph being displayed. A command line looks like this:
DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="THIS IS MY TITLE"
Important points:
1. No blanks between the key word (i.e. DATA), the equal sign and
the specification (i.e. EXAMPLE)
2. Case does not matter.
3. Titles MUST be enclosed in quotes
In this example, the database is specified by the DATA keyword, and the
database name is EXAMPLE. The GRAPH keyword specifies a PIE chart. The X
variable is has the field name STATUS, and the TITLE is "THIS IS MY TITLE".
@END
@DISPLAY BORDER
Required KWIKGRAF keywords for drawing a graph:
DATA= Specified datebase name
GRAPH= Specifies graph type. This can be PIE
HISTOGRAM, PICTOGRAPH, SCATTERPLOT,
TIMEPLOT or 3-D HISTOGRAM. These can be
abbreviated to PIE, HISTO, PICTO, SCAT,
TIME and 3-D.
X= Specifies field name of variable to use
If two variables are required, as in SCAT and 3-D, then a required
keyword is:
Y= Specifies second field name
@END
@DISPLAY BORDER
PIE CHART SUMMARY
-----------
Required Keywords: DATA=databasename
GRAPH=PIE
X=fieldname
Optional Keywords: TITLE="enclose title in quotes"
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=PIE X=STATUS TITLE="Pie Chart on Status"
Will produce the following graph:
@END
DATA=EXAMPLE GRAPH=PIE X=STATUS+
TITLE="Status from Example Database"
@DISPLAY BORDER
PICTOGRAM SUMMARY
----------
Required Keywords: DATA=databasename
GRAPH=PICTO
X=fieldname
IMG=imagefile
Optional Keywords: TITLE="enclose title in quotes"
Several image files are included on disk, including BAR1.IMG, which is a
small bar, and BAR2.IMG, which is a large bar. Images are created in the
utility module.
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=PICTO X=STATUS IMG=PERSON TITLE="Status"
Will produce the following graph:
@END
DATA=EXAMPLE GRAPH=PICTO X=STATUS IMG=PERSON TITLE="Status"
@DISPLAY BORDER
HISTOGRAM SUMMARY
----------
Required Keywords: DATA=databasename
GRAPH=HISTO
X=fieldname (must be numeric)
Optional Keywords: TITLE="enclose title in quotes"
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=HISTO X=AGE TITLE="Histogram on Age"
will produce the following graph:
@END
DATA=EXAMPLE GRAPH=HISTO X=AGE TITLE="Histogram on Age"
@DISPLAY BORDER
3-D BAR CHART SUMMARY
----------
Required Keywords: DATA=databasename
GRAPH=3-D
X=fieldname
Y=fieldname
Optional Keywords: TITLE="enclose title in quotes"
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"
will produce the following graph:
@END
DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"
@DISPLAY BORDER
SCATTERPLOT SUMMARY
----------
Required Keywords: DATA=databasename
GRAPH=SCAT
X=fieldname (must be numeric)
Y=fieldname (must be numeric)
Optional Keywords: TITLE="enclose title in quotes"
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
will produce the following graph:
@END
KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
@DISPLAY BORDER
TIME SERIES PLOT SUMMARY
----------
Required Keywords: DATA=databasename
GRAPH=TIME
X=fieldname (must be numeric)
Optional Keywords: TITLE="enclose title in quotes"
For example, the command from DOS
KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"
will produce the following graph:
@END
KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"
@DISPLAY BORDER
RUNNING KWIKGRAF from dBASE III
----------
From within dBASE III, either from command mode, or in a program, you can
cause a KWIKGRAPH graph to be produced by using the RUN command. For
example, to produce the last TIME SERIES PLOT, you would have used the
command:
.RUN KWIKGRAF DATA=EXAMPLE GRAPH=TIME X=TIME1 TITLE="Plot of Time1"
For this to work, the KWIKGRAF program needs to be in the same subdirectory
as dBASE III. Otherwise, you need to place the path name before the
KWIKGRAF command.
@END
@DISPLAY BORDER
USING KWIKGRAF COMMAND FILES
----------
This tutorial was written using a KWIKGRAF command file. This file
contains a series of KWIKGRAF commands, all following the same syntax as
if you had given the command from DOS. Here are some examples:
KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 TITLE="Time1 by Time2"
KWIKGRAF DATA=EXAMPLE GRAPH=3-D X=STATUS Y=GROUP TITLE="Status By Group"
If your command is too long for a line, your can place a "+" at the end
of the line, which will make KWIKGRAF continue to read it to the next
line. For example:
KWIKGRAF DATA=EXAMPLE GRAPH=SCAT X=TIME1 Y=TIME2 +
TITLE="Time1 by Time2"
continued . . .
@END
@DISPLAY BORDER
USING KWIKGRAF COMMAND FILES continued
----------
To cause text, such as what you are reading to be displayed, place the
command @DISPLAY on a line, followed by all of the lines to display, and
end the display with the command @END. If you place the keyword BORDER
on the line with @DISPLAY, a border will appear around the text. To run a
command file, enter the following command from DOS.
KWIKGRAF FILE=commandfile
Command files should have a .KG extension.
You may also run a command file from the KWIKGRAF menu. Simply select the
menu option "Run a KWIKGRAF command file," and you will be prompted to enter
the name of the command file to run. Speaking of menu mode ...
@END
@DISPLAY BORDER
The KWIKGRAF Menu
----------
If you enter the KWIKGRAF command from DOS with no other keywords, you will
be in "menu" mode, where you can interactively create graphs.
There are a few more options you can choose from the menu mode than from the
command mode, such as specifying certain minimums and maximums for graphs.
You can also run two other KWIKGRAF programs, KWIKDATA and KWIKUTIL
KWIKDATA - create a DATABASE file, enter data, manipulate data.
KWIKUTIL - Create an IMAGE, set colors and default disk, output reports.
@END
TABASE file, enter data, manipulate data.
KWIKUTIL - Cre